home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_groff.idb / usr / freeware / catman / u_man / cat1 / grodvi.Z / grodvi
Text File  |  2002-04-08  |  5KB  |  106 lines
  1. GRODVI(1)                        GRODVI(1)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        grodvi -    convert    groff output to    TeX dvi    format
  7.  
  8. SSYYNNOOPPSSIISS
  9.        ggrrooddvvii [    --ddvv ] [    --ww_n ] [    --FF_d_i_r ]    [ _f_i_l_e_s...  ]
  10.  
  11.        It  is  possible    to have    whitespace between a command line
  12.        option and its parameter.
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        ggrrooddvvii is a driver for ggrrooffff that produces TeX dvi format.
  16.        Normally     it  should be run by ggrrooffff --TTddvvii.  This will run
  17.        ttrrooffff --TTddvvii; it will  also  input  the  macros  //uussrr//ffrreeee
  18.        wwaarree//sshhaarree//ggrrooffff//11..1177..22//ttmmaacc//ddvvii..ttmmaacc;  if  the    input  is
  19.        being preprocessed with eeqqnn it will also    input  //uussrr//ffrreeee
  20.        wwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvddvvii//eeqqnncchhaarr.
  21.  
  22.        The  dvi     file  generated  by ggrrooddvvii can    be printed by any
  23.        correctly-written dvi driver.  The  troff  drawing  primi
  24.        tives  are  implemented using the tpic version 2    specials.
  25.        If the driver does not support these, the \\DD commands will
  26.        not produce any output.
  27.  
  28.        There is    an additional drawing command available:
  29.  
  30.        \\DD''RR _d_h _d_v''
  31.           Draw  a rule (solid black    rectangle), with one cor
  32.           ner at the current  position,  and  the  diagonally
  33.           opposite    corner    at the current position    +(_d_h,_d_v).
  34.           Afterwards the current  position    will  be  at  the
  35.           opposite    corner.      This produces    a rule in the dvi
  36.           file and so can be printed even with a driver  that
  37.           does not support the tpic    specials unlike    the other
  38.           \\DD commands.
  39.  
  40.        The groff command \\XX''_a_n_y_t_h_i_n_g'' is translated into the same
  41.        command    in  the     dvi  file  as would be    produced by \\ssppee
  42.        cciiaall{{_a_n_y_t_h_i_n_g}} in TeX; _a_n_y_t_h_i_n_g _m_a_y _n_o_t _c_o_n_t_a_i_n _a _n_e_w_l_i_n_e_.
  43.  
  44.        Font  files for ggrrooddvvii can be created from tfm files using
  45.        ttffmmttooddiitt(1).  The font description file should contain the
  46.        following additional commands:
  47.  
  48.        iinntteerrnnaallnnaammee _n_a_m_e
  49.              The  name    of the tfm file    (without the ..ttffmm
  50.              extension)    is _n_a_m_e.
  51.  
  52.        cchheecckkssuumm    _n    The checksum in the tfm file is _n.
  53.  
  54.        ddeessiiggnnssiizzee _n  The designsize in the tfm file is _n.
  55.  
  56.        These are automatically generated by ttffmmttooddiitt..
  57.  
  58.        In ttrrooffff    the \\NN escape sequence    can  be     used  to  access
  59.        characters  by  their  position    in  the    corresponding tfm
  60.        file; all characters in the tfm file can    be accessed  this
  61.        way.
  62.  
  63. OOPPTTIIOONNSS
  64.        --dd     Do  not use tpic specials    to implement drawing com
  65.           mands.   Horizontal  and    vertical  lines     will  be
  66.           implemented  by rules.  Other drawing commands will
  67.           be ignored.
  68.  
  69.        --vv     Print the    version    number.
  70.  
  71.        --ww_n    Set the default line thickness to    _n thousandths  of
  72.           an em.
  73.  
  74.        --FF_d_i_r  Prepend directory    _d_i_r//ddeevvddvvii to the search path for
  75.           font and device description files.
  76.  
  77. FFIILLEESS
  78.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvddvvii//DDEESSCC
  79.           Device description file.
  80.  
  81.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ffoonntt//ddeevvddvvii//_F
  82.           Font description file for    font _F.
  83.  
  84.        //uussrr//ffrreeeewwaarree//sshhaarree//ggrrooffff//11..1177..22//ttmmaacc//ddvvii..ttmmaacc
  85.           Macros for use with ggrrooddvvii.
  86.  
  87. BBUUGGSS
  88.        Dvi files produced by ggrrooddvvii use     a  different  resolution
  89.        (57816  units  per inch)    to those produced by TeX.  Incor
  90.        rectly written drivers which assume the resolution used by
  91.        TeX, rather than    using the resolution specified in the dvi
  92.        file will not work with ggrrooddvvii.
  93.  
  94.        When using the --dd option    with boxed tables,  vertical  and
  95.        horizontal  lines  can  sometimes  protrude  by one pixel.
  96.        This is a consequence of    the way     TeX  requires    that  the
  97.        heights and widths of rules be rounded.
  98.  
  99. SSEEEE AALLSSOO
  100.        ttffmmttooddiitt(1),    ggrrooffff(1),     ttrrooffff(1),        ggrrooffff__oouutt(5),
  101.        ggrrooffff__ffoonntt(5), ggrrooffff__cchhaarr(7)
  102.  
  103.  
  104.  
  105. Groff Version 1.17.2       27 June 2001            GRODVI(1)
  106.